home *** CD-ROM | disk | FTP | other *** search
/ Aminet 39 / Aminet 39 (2000)(Schatztruhe)[!][Oct 2000].iso / Aminet / comm / misc / easytransfer.lzh / EasyTransfer / EasyTransfer.doc < prev   
Encoding:
Text File  |  1995-11-21  |  7.4 KB  |  183 lines
  1.  
  2. Program name:  EasyTransfer V2.0ß
  3.  
  4. What it does:  Transfers files between an Amiga and IBM using a
  5.                3 wire serial NULL modem at up to 115200 bps
  6.  
  7. Author:        Kamran Karimi
  8.  
  9.  
  10. Directory contents:
  11.  
  12.  EasyAmiga <-- The program to run on Amiga
  13.  
  14.  EasyPC.EXE <-- The server to run on an IBM
  15.  
  16.  EasyTransfer.doc <-- The file yor are reading now
  17.  
  18.  AmigaSource/EasyAmiga.c
  19.             /Remote.c
  20.             /Local.c
  21.             /Serial.c
  22.             /EasyAmiga.h
  23.             /ErrCodes.h  <-- These are source files of EasyAmiga
  24.  
  25.  PCSource/EasyPC.c <-- Source file of EasyPC.EXE
  26.  
  27.            
  28.  This program is copyrighted, but you can use it freely.
  29. -----------------------------------------------------------------------------
  30.  
  31.  
  32. Here is a quick and dirty doc for EasyTransfer:
  33.  
  34.  EasyTransfer uses a 3 wire serial connection (see end of file) to transfer 
  35. files between Amiga and IBM compatibles. To use it, you should first transfer
  36. the EasyPC.exe program to an IBM machine. You can use programs like CrossDOS
  37. to do this. Run the EasyPC there. The program uses serial port 2 by 
  38. default, because many people use port 1 for mouse. Yot can ask the use
  39. of port 1 by using the '-1' command line option. option -2 is equivalent
  40. to default. The program shows a screen full of 'IBM' texts and gradually
  41. replaces them with 'AMIGA!'. if you specify '-v' or '-V' as command line
  42. options, the program shows messages indicating its workings. You can quit
  43. the server program any time by pressing Control-break.
  44.  
  45. Example: If you want to use serial port number 1 and also want to see
  46. what the program is doing, enter this command:  C:\> EasyPC -1 -v
  47.  
  48.  The Amiga program controles the whole scene. It opens a screen showing
  49. two windows. The right one is for Amiga files, the left one shows server
  50. directories.
  51.  
  52.  You start the session by first running the server on the PC. Then run the
  53. Amiga program. There is a 'CONFIG' gagdet in lower right of the screen,
  54. pressing it opens a configuration window in which you can enter the name
  55. of the serial device to use , serial device unit (if you have multiple 
  56. serial ports), a delay time which specifies how much the server and Amiga 
  57. should wait for a reply, a starting speed (more on this later) and the 
  58. method of hardware access on the PC, you can specify 'BIOS' to use BIOS 
  59. calls in serial port programming. This should be more compatible but limits 
  60. the maximum speed at 9600 bps. it can be used for example on PC emulators 
  61. on other computers. By choosing 'DIRECTLY', the upper limit of serial 
  62. transfer becomes 115200. The program can periodically check the cable
  63. connecting the machines, Enter a 0 here to prevent the check. Also,
  64. you can determine how many times the program should retransmit the 
  65. information if it gets corrupted.
  66.  
  67.  
  68.  The program determines the speed to use by choosing the speed in the 
  69. configuration window written under the name of starting speed. Then the
  70. Amiga and PC send each other packets of data at the specified speed and 
  71. check to see if the information was received intact. If successfull, the 
  72. speed is used, otherwise a lower speed is chosen and the whole thing
  73. is repeated. The method chosen in the program has some bugs and It
  74. is possible for the Amiga and PC never to synchronize even in very low
  75. transfer rates, if the initial speed is too high. Or the program may
  76. show frequent 'Synchronization Lost' messages or things like that.
  77. Try lowering the initial speed and see if every thing works all right.
  78. It is best to find a suitable speed by trial and error.
  79.  
  80.  Note that you may not be able to use high transfer rates because of the
  81. low speed of the Amiga or the PC. On an A1200 with fast ram and an IBM 
  82. 386DX 40MHz, with cache, 57600 pbs works fine. As The hardware of the PC 
  83. serial port can be used, while the Amiga Serial port is accessed only by its
  84. software drivers, the real limitation is caused by the Amiga.   
  85.  
  86.  The delay time is computed in seconds. The number you enter in configuration
  87. window is used on the server. The Amiga adds 2 seconds to that to make sure
  88. the two machines will synch. On both machines, an amount equal to the actual
  89. transfer time of the data is added to this. Delay time can not be zero.
  90. The main use of it is when dealing with slow devices.
  91.  
  92.  You can save the configuraion of your choice. The configuration file
  93. is S:EasyTransfer.Config.
  94.  
  95.  When the configuration is OK, press the CONNECT gadget. If every thing goes
  96. all right, the connection is established. Use the string gadget at the top
  97. left of the screen to enter PC directories, and the string gadget at the
  98. top right for Amiga. Enter the directory name and press return to change
  99. directory there and also see the directory contents. Double clicking on a
  100. directory name will cause the program to enter it. Press on PARENT to leave
  101. the directory, but do not use it while in the root directory of a disk. Press
  102. DELETE to delete a file or directory or MKDIR to create a new directory. 
  103. At any time, one of the Amiga or PC windows is active and the operations
  104. mentioned above applies to it. the active window is marked by being 'carved' 
  105. in the screen. The inactive one pops up.
  106.  
  107.  You can select files or directories to transfer by clicking the mouse on
  108. them. If the Amiga window is active, the CONNECT gadget will become SEND
  109. and if the PC window is active, it becomes RECEIVE. The CONFIG gadget 
  110. will turn into BINARY or TEXT, showing if a translation of files will take
  111. place (more on this later).
  112.  
  113.  Selecting a directory, causes all the files and directories inside it also 
  114. to be sent recursively. After a transfer, the program updates the 
  115. corresponding window by getting the new directory contents. 
  116.  
  117.  If TEXT option is chosen during a transfer, files comming from the server
  118. are searched for carriage returns and Control-Z characters. The files going 
  119. to the server are augmented with a carriage return whenever a linefeed is
  120. seen. When BINARY option is chosen, files won't change.
  121.  
  122.  The amount of transfered data is shown graphically in TELECOMMUNICATIONS
  123. subwindow. This is reserved for file transfers.
  124.  
  125.  You can cancel a transfer by hitting the ESCAPE key. If the program tries 
  126. to read a directory after cancelling a transfer, it may fail. Just wait a 
  127. few seconds and try again.
  128.  
  129.  Beware of long file names on the Amiga. Long file names will be truncated
  130. on the PC side. For example, if you send longfilename1 and longfilename2
  131. to the same directory of the PC, the last one will overwrite the first one.
  132. To prevent this from happening, use the gadget in the left of TEXT/BINARY
  133. gadget. When it shows PROTECT, the program will prevent overwrites on files
  134. already existing in the Amiga or PC directory. The OVR WRT is a sign that
  135. the program will not care about overwrites.
  136.  
  137. The program changes a starting '.' (like in .info) to '_'.
  138.  
  139.  Pressing EXIT will end the program, but befor that, the Amiga tries to 
  140. inform the server of the quit and the server will also quit.
  141.  
  142.  
  143.  
  144. CABLE:
  145.  
  146.  for a 3 wire serial connection:
  147.  
  148.  pin   to   pin
  149.   2          3
  150.   3          2
  151.   7          7
  152.  
  153.  for a 7 wire serial connection (used for testing this program):
  154.  
  155.  pin   to   pin
  156.   2          3
  157.   3          2
  158.   4          5
  159.   5          4
  160.   6         20
  161.  20          6
  162.   7          7
  163.  
  164.  
  165.  You may Also connect pins 8 and 6 locally on both sides. 
  166.  
  167.  Be careful with wiring and turn off both computers befor connecting a 
  168. cable
  169.  
  170.  
  171. My Address
  172.  
  173. Mail (More Reliable):
  174.  
  175.    Kamran Karimi
  176.    89-Nastaran/Ghandehari
  177.    Khosh Shomali str.
  178.    14578 - Tehran
  179.    IRAN
  180.  
  181.  
  182. Internet: karimik@sun.iust.ac.ir
  183.